
<!doctype html>
<html lang="zh" class="no-js">
  <head>
    
      <meta charset="utf-8">
      <meta name="viewport" content="width=device-width,initial-scale=1">
      
      
      
      
      <link rel="icon" href="assets/images/favicon.png">
      <meta name="generator" content="mkdocs-1.2.3, mkdocs-material-7.3.6">
    
    
      
        <title>HttpRunner V3.x中文文档</title>
      
    
    
      <link rel="stylesheet" href="assets/stylesheets/main.a57b2b03.min.css">
      
        
        <link rel="stylesheet" href="assets/stylesheets/palette.3f5d1f46.min.css">
        
      
    
    
    
      
        
        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,400,400i,700%7CRoboto+Mono&display=fallback">
        <style>:root{--md-text-font-family:"Roboto";--md-code-font-family:"Roboto Mono"}</style>
      
    
    
    
    
      


    
    
  </head>
  
  
    
    
    
    
    
    <body dir="ltr" data-md-color-scheme="" data-md-color-primary="none" data-md-color-accent="none">
  
    
    <script>function __prefix(e){return new URL(".",location).pathname+"."+e}function __get(e,t=localStorage){return JSON.parse(t.getItem(__prefix(e)))}</script>
    
    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
    <label class="md-overlay" for="__drawer"></label>
    <div data-md-component="skip">
      
        
        <a href="#_1" class="md-skip">
          跳转至
        </a>
      
    </div>
    <div data-md-component="announce">
      
    </div>
    
      

<header class="md-header" data-md-component="header">
  <nav class="md-header__inner md-grid" aria-label="Header">
    <a href="." title="HttpRunner V3.x中文文档" class="md-header__button md-logo" aria-label="HttpRunner V3.x中文文档" data-md-component="logo">
      
  
  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54z"/></svg>

    </a>
    <label class="md-header__button md-icon" for="__drawer">
      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2z"/></svg>
    </label>
    <div class="md-header__title" data-md-component="header-title">
      <div class="md-header__ellipsis">
        <div class="md-header__topic">
          <span class="md-ellipsis">
            HttpRunner V3.x中文文档
          </span>
        </div>
        <div class="md-header__topic" data-md-component="header-topic">
          <span class="md-ellipsis">
            
              名词解释
            
          </span>
        </div>
      </div>
    </div>
    
    
    
      <label class="md-header__button md-icon" for="__search">
        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg>
      </label>
      
<div class="md-search" data-md-component="search" role="dialog">
  <label class="md-search__overlay" for="__search"></label>
  <div class="md-search__inner" role="search">
    <form class="md-search__form" name="search">
      <input type="text" class="md-search__input" name="query" aria-label="搜索" placeholder="搜索" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
      <label class="md-search__icon md-icon" for="__search">
        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg>
        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg>
      </label>
      <nav class="md-search__options" aria-label="Search">
        
        <button type="reset" class="md-search__icon md-icon" aria-label="Clear" tabindex="-1">
          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41z"/></svg>
        </button>
      </nav>
      
    </form>
    <div class="md-search__output">
      <div class="md-search__scrollwrap" data-md-scrollfix>
        <div class="md-search-result" data-md-component="search-result">
          <div class="md-search-result__meta">
            正在初始化搜索引擎
          </div>
          <ol class="md-search-result__list"></ol>
        </div>
      </div>
    </div>
  </div>
</div>
    
    
  </nav>
  
</header>
    
    <div class="md-container" data-md-component="container">
      
      
        
          
        
      
      <main class="md-main" data-md-component="main">
        <div class="md-main__inner md-grid">
          
            
              
              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
                <div class="md-sidebar__scrollwrap">
                  <div class="md-sidebar__inner">
                    


<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
  <label class="md-nav__title" for="__drawer">
    <a href="." title="HttpRunner V3.x中文文档" class="md-nav__button md-logo" aria-label="HttpRunner V3.x中文文档" data-md-component="logo">
      
  
  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54z"/></svg>

    </a>
    HttpRunner V3.x中文文档
  </label>
  
  <ul class="md-nav__list" data-md-scrollfix>
    
      
      
      

  
  
    
  
  
    <li class="md-nav__item md-nav__item--active">
      
      <input class="md-nav__toggle md-toggle" data-md-toggle="toc" type="checkbox" id="__toc">
      
      
        
      
      
        <label class="md-nav__link md-nav__link--active" for="__toc">
          名词解释
          <span class="md-nav__icon md-icon"></span>
        </label>
      
      <a href="." class="md-nav__link md-nav__link--active">
        名词解释
      </a>
      
        


<nav class="md-nav md-nav--secondary" aria-label="目录">
  
  
  
    
  
  
    <label class="md-nav__title" for="__toc">
      <span class="md-nav__icon md-icon"></span>
      目录
    </label>
    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
      
        <li class="md-nav__item">
  <a href="#_2" class="md-nav__link">
    特别说明
  </a>
  
</li>
      
        <li class="md-nav__item">
  <a href="#har" class="md-nav__link">
    HAR
  </a>
  
</li>
      
        <li class="md-nav__item">
  <a href="#jmespath" class="md-nav__link">
    JMESPath
  </a>
  
</li>
      
        <li class="md-nav__item">
  <a href="#teststep" class="md-nav__link">
    测试步骤（teststep）
  </a>
  
</li>
      
        <li class="md-nav__item">
  <a href="#testcase" class="md-nav__link">
    测试用例（testcase）
  </a>
  
</li>
      
        <li class="md-nav__item">
  <a href="#testsuite" class="md-nav__link">
    测试用例集（testsuite）
  </a>
  
</li>
      
        <li class="md-nav__item">
  <a href="#_3" class="md-nav__link">
    测试场景
  </a>
  
</li>
      
        <li class="md-nav__item">
  <a href="#debugtalkpy" class="md-nav__link">
    debugtalk.py
  </a>
  
</li>
      
        <li class="md-nav__item">
  <a href="#_4" class="md-nav__link">
    变量优先级
  </a>
  
    <nav class="md-nav" aria-label="变量优先级">
      <ul class="md-nav__list">
        
          <li class="md-nav__item">
  <a href="#_5" class="md-nav__link">
    在测试用例中：
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#_6" class="md-nav__link">
    在测试套件中：
  </a>
  
</li>
        
      </ul>
    </nav>
  
</li>
      
    </ul>
  
</nav>
      
    </li>
  

    
      
      
      

  
  
  
    <li class="md-nav__item">
      <a href="10-HttpRunner%E7%AE%80%E4%BB%8B/" class="md-nav__link">
        简介
      </a>
    </li>
  

    
      
      
      

  
  
  
    <li class="md-nav__item">
      <a href="20-HttpRunner%E5%AE%89%E8%A3%85/" class="md-nav__link">
        安装
      </a>
    </li>
  

    
      
      
      

  
  
  
    
    <li class="md-nav__item md-nav__item--nested">
      
      
        <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_4" type="checkbox" id="__nav_4" >
      
      
      
      
        <label class="md-nav__link" for="__nav_4">
          用户指南
          <span class="md-nav__icon md-icon"></span>
        </label>
      
      <nav class="md-nav" aria-label="用户指南" data-md-level="1">
        <label class="md-nav__title" for="__nav_4">
          <span class="md-nav__icon md-icon"></span>
          用户指南
        </label>
        <ul class="md-nav__list" data-md-scrollfix>
          
            
              
  
  
  
    <li class="md-nav__item">
      <a href="%E7%94%A8%E6%88%B7%E6%8C%87%E5%8D%97/31-%E6%A6%82%E8%BF%B0/" class="md-nav__link">
        HttpRunner概念
      </a>
    </li>
  

            
          
            
              
  
  
  
    <li class="md-nav__item">
      <a href="%E7%94%A8%E6%88%B7%E6%8C%87%E5%8D%97/32-%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B/" class="md-nav__link">
        快速上手
      </a>
    </li>
  

            
          
            
              
  
  
  
    <li class="md-nav__item">
      <a href="%E7%94%A8%E6%88%B7%E6%8C%87%E5%8D%97/33-%E5%BD%95%E5%88%B6%E5%B9%B6%E7%94%9F%E6%88%90%E6%B5%8B%E8%AF%95%E6%8A%A5%E5%91%8A/" class="md-nav__link">
        录制并生成测试用例
      </a>
    </li>
  

            
          
            
              
  
  
  
    <li class="md-nav__item">
      <a href="%E7%94%A8%E6%88%B7%E6%8C%87%E5%8D%97/34-%E7%BC%96%E5%86%99%E6%B5%8B%E8%AF%95%E7%94%A8%E4%BE%8B/" class="md-nav__link">
        编写测试用例
      </a>
    </li>
  

            
          
            
              
  
  
  
    <li class="md-nav__item">
      <a href="%E7%94%A8%E6%88%B7%E6%8C%87%E5%8D%97/35-%E8%BF%90%E8%A1%8C%E6%B5%8B%E8%AF%95%E7%94%A8%E4%BE%8B/" class="md-nav__link">
        运行测试用例
      </a>
    </li>
  

            
          
            
              
  
  
  
    <li class="md-nav__item">
      <a href="%E7%94%A8%E6%88%B7%E6%8C%87%E5%8D%97/36-%E6%B5%8B%E8%AF%95%E6%8A%A5%E5%91%8A/" class="md-nav__link">
        测试报告
      </a>
    </li>
  

            
          
            
              
  
  
  
    <li class="md-nav__item">
      <a href="%E7%94%A8%E6%88%B7%E6%8C%87%E5%8D%97/37-%E8%BF%90%E8%A1%8C%E8%B4%9F%E8%BD%BD%E6%B5%8B%E8%AF%95/" class="md-nav__link">
        运行负载测试
      </a>
    </li>
  

            
          
            
              
  
  
  
    <li class="md-nav__item">
      <a href="%E7%94%A8%E6%88%B7%E6%8C%87%E5%8D%97/39-%E5%8F%91%E5%B8%83%E5%8E%86%E5%8F%B2/" class="md-nav__link">
        发布历史
      </a>
    </li>
  

            
          
        </ul>
      </nav>
    </li>
  

    
      
      
      

  
  
  
    
    <li class="md-nav__item md-nav__item--nested">
      
      
        <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5" type="checkbox" id="__nav_5" >
      
      
      
      
        <label class="md-nav__link" for="__nav_5">
          补充
          <span class="md-nav__icon md-icon"></span>
        </label>
      
      <nav class="md-nav" aria-label="补充" data-md-level="1">
        <label class="md-nav__title" for="__nav_5">
          <span class="md-nav__icon md-icon"></span>
          补充
        </label>
        <ul class="md-nav__list" data-md-scrollfix>
          
            
              
  
  
  
    <li class="md-nav__item">
      <a href="%E8%A1%A5%E5%85%85/10-%E9%A1%B9%E7%9B%AE%E6%96%87%E4%BB%B6%E7%BB%84%E7%BB%87/" class="md-nav__link">
        项目文件组织
      </a>
    </li>
  

            
          
            
              
  
  
  
    <li class="md-nav__item">
      <a href="%E8%A1%A5%E5%85%85/20-%E6%B5%8B%E8%AF%95%E7%94%A8%E4%BE%8B%E7%BB%84%E7%BB%87/" class="md-nav__link">
        测试用例组织
      </a>
    </li>
  

            
          
            
              
  
  
  
    <li class="md-nav__item">
      <a href="%E8%A1%A5%E5%85%85/30-Hook%E6%9C%BA%E5%88%B6/" class="md-nav__link">
        Hook机制
      </a>
    </li>
  

            
          
            
              
  
  
  
    <li class="md-nav__item">
      <a href="%E8%A1%A5%E5%85%85/40-%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F/" class="md-nav__link">
        环境变量
      </a>
    </li>
  

            
          
            
              
  
  
  
    <li class="md-nav__item">
      <a href="%E8%A1%A5%E5%85%85/50-%E6%B5%8B%E8%AF%95%E7%94%A8%E4%BE%8B%E5%88%86%E5%B1%82/" class="md-nav__link">
        测试用例分层
      </a>
    </li>
  

            
          
            
              
  
  
  
    <li class="md-nav__item">
      <a href="%E8%A1%A5%E5%85%85/60-%E5%8F%82%E6%95%B0%E5%8C%96%E6%95%B0%E6%8D%AE%E9%A9%B1%E5%8A%A8/" class="md-nav__link">
        参数化数据驱动
      </a>
    </li>
  

            
          
            
              
  
  
  
    <li class="md-nav__item">
      <a href="%E8%A1%A5%E5%85%85/70-%E6%96%87%E4%BB%B6%E4%B8%8A%E4%BC%A0%E5%9C%BA%E6%99%AF/" class="md-nav__link">
        文件上传场景
      </a>
    </li>
  

            
          
        </ul>
      </nav>
    </li>
  

    
  </ul>
</nav>
                  </div>
                </div>
              </div>
            
            
              
              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
                <div class="md-sidebar__scrollwrap">
                  <div class="md-sidebar__inner">
                    


<nav class="md-nav md-nav--secondary" aria-label="目录">
  
  
  
    
  
  
    <label class="md-nav__title" for="__toc">
      <span class="md-nav__icon md-icon"></span>
      目录
    </label>
    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
      
        <li class="md-nav__item">
  <a href="#_2" class="md-nav__link">
    特别说明
  </a>
  
</li>
      
        <li class="md-nav__item">
  <a href="#har" class="md-nav__link">
    HAR
  </a>
  
</li>
      
        <li class="md-nav__item">
  <a href="#jmespath" class="md-nav__link">
    JMESPath
  </a>
  
</li>
      
        <li class="md-nav__item">
  <a href="#teststep" class="md-nav__link">
    测试步骤（teststep）
  </a>
  
</li>
      
        <li class="md-nav__item">
  <a href="#testcase" class="md-nav__link">
    测试用例（testcase）
  </a>
  
</li>
      
        <li class="md-nav__item">
  <a href="#testsuite" class="md-nav__link">
    测试用例集（testsuite）
  </a>
  
</li>
      
        <li class="md-nav__item">
  <a href="#_3" class="md-nav__link">
    测试场景
  </a>
  
</li>
      
        <li class="md-nav__item">
  <a href="#debugtalkpy" class="md-nav__link">
    debugtalk.py
  </a>
  
</li>
      
        <li class="md-nav__item">
  <a href="#_4" class="md-nav__link">
    变量优先级
  </a>
  
    <nav class="md-nav" aria-label="变量优先级">
      <ul class="md-nav__list">
        
          <li class="md-nav__item">
  <a href="#_5" class="md-nav__link">
    在测试用例中：
  </a>
  
</li>
        
          <li class="md-nav__item">
  <a href="#_6" class="md-nav__link">
    在测试套件中：
  </a>
  
</li>
        
      </ul>
    </nav>
  
</li>
      
    </ul>
  
</nav>
                  </div>
                </div>
              </div>
            
          
          <div class="md-content" data-md-component="content">
            <article class="md-content__inner md-typeset">
              
                
                
                <h1 id="_1">名词解释</h1>
<h2 id="_2">特别说明</h2>
<p>本文是针对<a href="https://docs.httprunner.org/">httprunner v3.x英文文档</a> 进行1:1的中文翻译。希望对大家有帮助。</p>
<p>除名词解释和补充2个栏目外，其他栏目均按照HttpRunner V3.x英文文档进行翻译而来。</p>
<p>建议学习顺序为：</p>
<ul>
<li>名词解释：了解HAR、JMESPath，了解测试集、测试用例、测试步骤之间的关系</li>
<li>快速上手：动手创建新项目</li>
<li>打开创建的项目：使用Pycharm等编辑器，打开项目，了解项目的结构和配置文件</li>
<li>录制测试用例：动手用抓包工具录制测试用例，得到Har文件</li>
<li>生成测试用例：用httpRunner的har2case命令，生成测试用例</li>
<li>编写测试用例：重点掌握测试用例结构、链式调用</li>
<li>运行测试用例：运行测试用例的3种方式及hrun 命令</li>
<li>生成测试报告：内置HTML报告、allure 报告</li>
<li>补充：由于其他章节都是按照英文版1:1翻译过来的，所以笔者单独新增了一个补充模块，并参考了《HttpRunner V2.x 中文使用文档》</li>
</ul>
<h2 id="har">HAR</h2>
<p>HAR的全称为-HTTP Archive（HTTP档案文件），用来存储HTTP请求/响应信息的通用文件格式，基于JSON。</p>
<p>这个格式的出现可以使HTTP监测工具以一种通用的格式导出所收集的数据，这些数据可以被其他支持HAR的HTTP分析工具（包括Firebug，Httpwatch，Fiddler，Charles等）所使用。目前HAR规范最新版本为HAR 1.2。</p>
<p>一个HAR文件就是一个JSON对象，它由很多属性和子对象组成，如：</p>
<ul>
<li>version属性：表示HAR的版本</li>
<li>request对象：包含了请求的详细信息</li>
<li>response对象：包含响应的详细信息</li>
<li>cookies对象：包含了所有的cookie</li>
<li>headers对象：包含了所有的header</li>
<li>queryString对象：包含了查询字符串中所有的paramter-value对</li>
<li>postData对象：包含了POST的数据</li>
</ul>
<p>使用Fiddler、charles等工具，能轻松的导出会话的HAR文件。</p>
<h2 id="jmespath">JMESPath</h2>
<p><a href="https://jmespath.org">JMESPath</a>是一种JSON查询语言。您可以从JSON文档中提取和转换元素。</p>
<p>在执行测试用例时，如果Response 返回的消息格式为JSON格式，那么用JMESPath表达式进行提取，是一件非常轻松的事。提取出来的Response 响应消息的内容，我们可以用来做断言判断或者给下一个接口传递参数。</p>
<h2 id="teststep">测试步骤（teststep）</h2>
<p>一个测试用例由一个或多个测试步骤组成，测试用例是测试步骤的有序集合，而对于接口测试来说，每一个测试步骤应该就对应一个 API 的请求描述。</p>
<h2 id="testcase">测试用例（testcase）</h2>
<p>一般来讲，一条测试用例（testcase）应该是为了测试某个特定的功能逻辑而精心设计的，并且至少包含如下几点：</p>
<ul>
<li>明确的测试目的（achieve a particular software testing objective）</li>
<li>明确的输入（inputs）</li>
<li>明确的运行环境（execution conditions）</li>
<li>明确的测试步骤描述（testing procedure）</li>
<li>明确的预期结果（expected results）</li>
</ul>
<p>对应地，HttpRunner 的测试用例描述方式进行如下设计：</p>
<ul>
<li>测试用例应该是完整且独立的，每条测试用例应该是都可以独立运行的；在 HttpRunner 中，每个 YAML/JSON 文件对应一条测试用例。</li>
<li>测试用例包含测试脚本和测试数据两部分：</li>
<li>测试用例 = 测试脚本 + 测试数据</li>
<li>测试脚本重点是描述测试的业务功能逻辑，包括预置条件、测试步骤、预期结果等，并且可以结合辅助函数（debugtalk.py）实现复杂的运算逻辑；也可以将测试脚本理解为编程语言中的 类（class）；</li>
<li>测试数据重点是对应测试的业务数据逻辑，可以理解为类的实例化数据；</li>
<li>测试数据和测试脚本分离后，就可以比较方便地实现数据驱动测试，通过对测试脚本传入一组数据，实现同一业务功能在不同数据逻辑下的测试验证。</li>
</ul>
<h2 id="testsuite">测试用例集（testsuite）</h2>
<p>测试用例集是测试用例的无序集合，集合中的测试用例应该都是相互独立，不存在先后依赖关系的。</p>
<p>如果确实存在先后依赖关系怎么办，例如登录功能和下单功能。正确的做法应该是，在下单测试用例的前置步骤中执行登录操作的测试用例。</p>
<pre><code class="language-yaml">config:
    name: &quot;request methods testcase: reference testcase&quot;

teststeps:
-
    name: step1
    testcase: testcases/login.yml

-
    name: step2
    api: api/add_cart.yml

-
    name: step3
    api: api/make_order.yml
</code></pre>
<h2 id="_3">测试场景</h2>
<p>测试场景和测试用例集是同一概念，都是测试用例的无序集合。</p>
<ul>
<li>接口</li>
<li>测试用例集</li>
<li>参数</li>
<li>变量</li>
<li>测试脚本（YAML/JSON）</li>
<li>debugtalk.py</li>
<li>环境变量</li>
</ul>
<h2 id="debugtalkpy">debugtalk.py</h2>
<p>每个项目有且只有一个debugtalk.py，该文件拥有多种功能。</p>
<p>首先：项目根目录以<code>debugtalk.py</code>为锚点，测试用例中的相对路径都基于此根路径（例如引用测试用例或CSV文件等）。</p>
<p>然后：debugtalk是Httprunner的辅助函数，一些公共函数方法都可以定义在这里。主要应用场景如下：</p>
<ul>
<li>获取token</li>
<li>前置处理函数setup_hooks和后置处理函数teardown_hooks</li>
<li>加解密</li>
<li>sign认证</li>
<li>操作数据库</li>
<li>编写随机函数</li>
<li>读取图片等函数</li>
<li>制造参数化的数据</li>
<li>对返回数据类型进行转换</li>
<li>参数化cvs里面数据类型的转换</li>
</ul>
<p>例1：编写一个公共函数，用来获取httprunner的版本</p>
<p>在debugtalk.py中，添加get_httprunner_version()函数：</p>
<pre><code class="language-python">from httprunner import __version__

def get_httprunner_version():
    return __version__
</code></pre>
<p>在测试用例脚本等地方引用（格式为：${方法名}），如：</p>
<pre><code class="language-python">.with_headers(
    **{
        &quot;User-Agent&quot;:&quot;HttpRunner/${get_httprunner_version()}&quot;
    }
)
</code></pre>
<h2 id="_4">变量优先级</h2>
<h3 id="_5">在测试用例中：</h3>
<p>在pytest测试用例中，存在四种类型的变量，分别是：</p>
<p>测试步骤变量、提取变量、参数变量、配置变量。</p>
<p>在工作中，我们很少会用同名的变量名，如果您必须使用同名的变量，那么就应该了解一下变量的优先级。</p>
<p>以如下测试用例为例：</p>
<pre><code class="language-yaml">config:
    name: xxx
    variables:              # 配置变量(config variables)
        varA: &quot;configA&quot;
        varB: &quot;configB&quot;
        varC: &quot;configC&quot;
    parameters:             # 参数变量(parameter variables)
        varA: [&quot;paramA1&quot;]
        varB: [&quot;paramB1&quot;]

teststeps:
-
    name: step 1
    variables:              # 测试步骤变量(step variables)
        varA: &quot;step1A&quot;
    request:
        url: /$varA/$varB/$varC 
        #传入变量具体值：varA=&quot;step1A&quot;, varB=&quot;paramB1&quot;, varC=&quot;configC&quot;
        method: GET
    extract:                # 提取变量(extract variables)
        varA: body.data.A   # 假设 varA=&quot;extractVarA&quot;
        varB: body.data.B   # 假设 varB=&quot;extractVarB&quot;
-
    name: step 2
    varialbes:
        varA: &quot;step2A&quot;
    request:
        url: /$varA/$varB/$varC
        #传入变量具体值：varA=&quot;step2A&quot;, varB=&quot;extractVarB&quot;, varC=&quot;configC&quot;
        method: GET
</code></pre>
<p>在一个测试用例中，变量优先级如下：</p>
<ul>
<li>参数变量 &gt; 配置变量，例如：步骤1，varB="paramB1"</li>
<li>测试步骤变量&gt; 提取变量，例如：步骤2，varA="step2A"</li>
<li>提取变量 &gt; 参数变量 &gt; 配置变量，例如：步骤2，varB="extractVarB"，为步骤1提取的值</li>
<li>配置变量的优先级最低，例如：步骤1/2, varC="configC"</li>
</ul>
<p>总结：在以上四种变量中，优先级从低到高依次为：</p>
<p>测试步骤变量 &gt; 提取变量 &gt; 参数变量 &gt; 配置变量。</p>
<h3 id="_6">在测试套件中：</h3>
<p>在pytest测试套件中，存在四种类型的变量，分别是：</p>
<p>测试套件变量、输出变量、测试套件配置变量、引用的测试用例配置变量。</p>
<p>以如下测试套件为例：</p>
<pre><code class="language-yaml">config:
    name: xxx
    variables:               # 测试套件配置变量（testsuite config variables）
        varA: &quot;configA&quot;
        varB: &quot;configB&quot;
        varC: &quot;configC&quot;

testcases:
-
    name: case 1
    variables:               # 测试套件变量（testcase variables）
        varA: &quot;case1A&quot;
    testcase: /path/to/testcase1
    export: [&quot;varA&quot;, &quot;varB&quot;] # 输出变量（export variables）
-
    name: case 2
    varialbes:               # 测试套件变量（testcase variables）
        varA: &quot;case2A&quot;
    testcase: /path/to/testcase2
</code></pre>
<p>在测试套件中，变量优先级如下：</p>
<ul>
<li>测试套件变量 &gt; 输出变量 &gt; 测试套件配置变量 > 引用的测试用例配置变量</li>
</ul>
                
              
              
                


              
            </article>
          </div>
        </div>
        
      </main>
      
        
<footer class="md-footer">
  
    <nav class="md-footer__inner md-grid" aria-label="Footer">
      
      
        
        <a href="10-HttpRunner%E7%AE%80%E4%BB%8B/" class="md-footer__link md-footer__link--next" aria-label="下一页: 简介" rel="next">
          <div class="md-footer__title">
            <div class="md-ellipsis">
              <span class="md-footer__direction">
                下一页
              </span>
              简介
            </div>
          </div>
          <div class="md-footer__button md-icon">
            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4z"/></svg>
          </div>
        </a>
      
    </nav>
  
  <div class="md-footer-meta md-typeset">
    <div class="md-footer-meta__inner md-grid">
      <div class="md-footer-copyright">
        
        
          Made with
          <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
            Material for MkDocs
          </a>
        
        
      </div>
      
    </div>
  </div>
</footer>
      
    </div>
    <div class="md-dialog" data-md-component="dialog">
      <div class="md-dialog__inner md-typeset"></div>
    </div>
    <script id="__config" type="application/json">{"base": ".", "features": [], "translations": {"clipboard.copy": "\u590d\u5236", "clipboard.copied": "\u5df2\u590d\u5236", "search.config.lang": "ja", "search.config.pipeline": "trimmer, stemmer", "search.config.separator": "[\\uff0c\\u3002]+", "search.placeholder": "\u641c\u7d22", "search.result.placeholder": "\u952e\u5165\u4ee5\u5f00\u59cb\u641c\u7d22", "search.result.none": "\u6ca1\u6709\u627e\u5230\u7b26\u5408\u6761\u4ef6\u7684\u7ed3\u679c", "search.result.one": "\u627e\u5230 1 \u4e2a\u7b26\u5408\u6761\u4ef6\u7684\u7ed3\u679c", "search.result.other": "# \u4e2a\u7b26\u5408\u6761\u4ef6\u7684\u7ed3\u679c", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.term.missing": "Missing", "select.version.title": "Select version"}, "search": "assets/javascripts/workers/search.fcfe8b6d.min.js", "version": null}</script>
    
    
      <script src="assets/javascripts/bundle.b1047164.min.js"></script>
      
    
  </body>
</html>